org.springframework.test.web.client

Class AbstractRequestExpectationManager

java.lang.Object

org.springframework.test.web.client.AbstractRequestExpectationManager

All Implemented Interfaces:

RequestExpectationManager

Direct Known Subclasses:

SimpleRequestExpectationManager, UnorderedRequestExpectationManager

public abstract class AbstractRequestExpectationManager
extends java.lang.Object
implements RequestExpectationManager

Base class for RequestExpectationManager implementations responsible for storing expectations and actual requests, and checking for unsatisfied expectations at the end.

Subclasses are responsible for validating each request by matching it to to expectations following the order of declaration or not.

Since:

4.3

Author:

Rossen Stoyanchev, Juergen Hoeller

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	AbstractRequestExpectationManager.RequestExpectationGroup Helper class to manage a group of remaining expectations.

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.List<RequestExpectation>	expectations
private java.util.List<ClientHttpRequest>	requests

Constructor Summary

Constructors

Constructor and Description
AbstractRequestExpectationManager()

Method Summary

Modifier and Type	Method and Description
protected void	afterExpectationsDeclared() Invoked at the time of the first actual request, which effectively means the expectations declaration phase is over.
protected java.lang.AssertionError	createUnexpectedRequestError(ClientHttpRequest request) Return an AssertionError that a sub-class can raise for an unexpected request.
ResponseActions	expectRequest(ExpectedCount count, RequestMatcher matcher) Set up a new request expectation.
protected java.util.List<RequestExpectation>	getExpectations() Return a read-only list of the expectations.
protected java.lang.String	getRequestDetails() Return details of executed requests.
protected java.util.List<ClientHttpRequest>	getRequests() Return a read-only list of requests executed so far.
void	reset() Reset the internal state removing all expectations and recorded requests.
ClientHttpResponse	validateRequest(ClientHttpRequest request) Validate the given actual request against the declared expectations.
protected abstract ClientHttpResponse	validateRequestInternal(ClientHttpRequest request) Sub-classes must implement the actual validation of the request matching to declared expectations.
void	verify() Verify that all expectations have been met.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

expectations

private final java.util.List<RequestExpectation> expectations

requests

private final java.util.List<ClientHttpRequest> requests

Constructor Detail

AbstractRequestExpectationManager

public AbstractRequestExpectationManager()

Method Detail

getExpectations

protected java.util.List<RequestExpectation> getExpectations()

Return a read-only list of the expectations.

getRequests

protected java.util.List<ClientHttpRequest> getRequests()

Return a read-only list of requests executed so far.

expectRequest

public ResponseActions expectRequest(ExpectedCount count,
                                     RequestMatcher matcher)

Description copied from interface: RequestExpectationManager

Set up a new request expectation. The returned ResponseActions is used to add more expectations and define a response.

Specified by:

expectRequest in interface RequestExpectationManager

matcher - a request expectation

Returns:

for setting up further expectations and define a response

validateRequest

public ClientHttpResponse validateRequest(ClientHttpRequest request)
                                   throws java.io.IOException

Description copied from interface: RequestExpectationManager

Validate the given actual request against the declared expectations. Is successful return the mock response to use or raise an error.

Specified by:

validateRequest in interface RequestExpectationManager

Parameters:

request - the request

Returns:

the response to return if the request was validated.

Throws:

java.io.IOException - in case of any validation errors

afterExpectationsDeclared

protected void afterExpectationsDeclared()

Invoked at the time of the first actual request, which effectively means the expectations declaration phase is over.

validateRequestInternal

protected abstract ClientHttpResponse validateRequestInternal(ClientHttpRequest request)
                                                       throws java.io.IOException

Sub-classes must implement the actual validation of the request matching to declared expectations.

Throws:

java.io.IOException

verify

public void verify()

Description copied from interface: RequestExpectationManager

Verify that all expectations have been met.

Specified by:

verify in interface RequestExpectationManager

getRequestDetails

protected java.lang.String getRequestDetails()

Return details of executed requests.

createUnexpectedRequestError

protected java.lang.AssertionError createUnexpectedRequestError(ClientHttpRequest request)

Return an AssertionError that a sub-class can raise for an unexpected request.

reset

public void reset()

Description copied from interface: RequestExpectationManager

Reset the internal state removing all expectations and recorded requests.

Specified by:

reset in interface RequestExpectationManager